home *** CD-ROM | disk | FTP | other *** search
/ Giga Games 1 / Giga Games.iso / net / d_d / stanford / charshts / seabrook / doc / charshet.mm
Encoding:
Text File  |  1993-06-22  |  13.6 KB  |  600 lines

  1. .\"    charsheet:charsheet.mm    1.11
  2. .\"
  3. .\"    Copyright 1991, Chris Seabrook
  4. .\"
  5. .\"    This work may be freely used. modified and distributed for non-commercial
  6. .\"    purposes so long as it retains this notice.
  7. .\"
  8. .\"    format using: pic | troff -mm
  9. .TL
  10. AD&D\(rg 2nd Edition Character Sheet \fCpic\fP Macros
  11. .AF ""
  12. .AU "Chris Seabrook"
  13. .AU "Mary Seabrook"
  14. .AS
  15. This document describes a set of \fCpic\fP macros used for generating
  16. customised character sheets for AD&D 2nd edition characters.
  17. .AE
  18. .MT 4
  19. .PF "'charsheet:charsheet.mm''Vesion: 1.11'"
  20. .PS
  21. copy "../macros/main"
  22. scale=1.25
  23. .PE
  24. .H 1 "Introduction"
  25. The problem with designing character sheets for AD&D characters has always
  26. been the differing information required for different character classes and
  27. races.
  28. In an effort to overcome this the macro set described by this document breaks
  29. the character sheet down into a series of standard pieces which can be included
  30. or excluded to build a customised sheet for a particular chracter.
  31. Thus a fighter no longer has an empty box on his or her sheet for thieves
  32. skills,
  33. many of the pieces are of configurable size as well,
  34. so a wizard does not need to have many blank weapon proficiency slots just
  35. because a fighter will need many more.
  36. .P
  37. The macro package also contains macros to fill in information in the various
  38. sections,
  39. so it is possible to use this system to keep an online version of a particular
  40. characters sheet as well as simply producing blanks for players to fill in by
  41. hand.
  42. .P
  43. The standard version of \fCpic\fP installed on most machines restricts the
  44. size of a picture to 8 inches square,
  45. which poses a problem when trying to make up an 8\(12 by 11 sheet.
  46. Users must either find (or create) a modified version of pic which can deal with
  47. larger pictures (the 8x8 is only a constant within pic) or leave a
  48. considerable ammount of space at the foot of each page.
  49. .H 1 "The Macros"
  50. Each character sheet input file is a \fCtroff\fP document which is
  51. pre-processed by \fCpic\fP.
  52. The \fCpic\fP input should include the macros by including the collection
  53. file \fC../macros/main\fP,
  54. this in turn will include all of the other macros files from \fC../macros\fP.
  55. The macros can then be used in any order with each page appearing between
  56. a \fC.PS\fP and a \fC.PE\fP macro.
  57. The only condition on ordering the macros is that the \fBtitle\fP macro
  58. should be called at the top of each page,
  59. and that the \fBnotes\fP and \fBmoney\fP macros are intended to be called at
  60. the bottom of a page.
  61. .P
  62. .DS I
  63. .ft C
  64. \\.po -0.5i
  65. \\.PS
  66. copy "../macros/main"
  67. title(\fIName, Race, Class, Level, Alignment\fP)
  68. \\......
  69. notes()
  70. \\.PE
  71. \\.bp
  72. \\.PS
  73. copy "../macros/main"
  74. title(\fIName, Race, Class, Level, Alignment\fP)
  75. \\......
  76. money(gold, experience, next)
  77. \\.PE
  78. .DE
  79. .P
  80. Note the \fC.po -0.5i\fP at the head of the document.
  81. This improves the overall positioning on the page.
  82. .H 2 "The \fBtitle\fP Macro"
  83. The \fBtitle\fP macro takes 5 arguments,
  84. the characters name,
  85. race,
  86. class,
  87. level,
  88. and alignment.
  89. This macro establishes the position at the top of the page and all other
  90. sections on the page are placed relative to it,
  91. so a \fBtitle\fP call must head each page.
  92. .P
  93. .ne 2.0i
  94. The calls
  95. .P
  96. .DS I
  97. .ft C
  98. title(Garth, Human, Fighter, 4, LG)
  99. .DE
  100. .P
  101. will produce
  102. .P
  103. .PS
  104. title(Garth, Human, Fighter, 4, LG)
  105. .PE
  106. .P
  107. Multi classed characters should specify both classes and both levels as single
  108. arguments.
  109. .P
  110. .ne 2.0i
  111. The calls
  112. .P
  113. .DS I
  114. .ft C
  115. title(Garth, Human, Fighter/Thief, 4/6, LG)
  116. .DE
  117. .P
  118. will produce
  119. .P
  120. .PS
  121. title(Garth, Human, Fighter/Thief, 4/6, LG)
  122. .PE
  123. .H 2 "The \fBstats\fP Macro"
  124. The \fBstats\fP macro is divided into 3 sections due to \fCpic\fP's limitation
  125. of only 9 arguments to a macro.
  126. The main \fBstats\fP macro draws all of the structure of this section and
  127. fills in the values for the primary statistics.
  128. Fighters should denote exceptional strength (18 + percentage) as 18.<%age>,
  129. eg. 18(31) as 18.31.
  130. This is important as the value is used later by the \fBencumbrance\fP macro to
  131. calculate movement rates.
  132. The call to \fBstats\fP can then be followed by calls to \fBstats1\fP and
  133. \fBstats2\fP to fill in the remaining values.
  134. .P
  135. The specific arguments to the macros are
  136. .P
  137. .DS I
  138. stats(Str, Int, Wis, Dex, Con, Cha)
  139. stats1(AC, HP, Reaction, Doors, Bars, Handed, Sex)
  140. stats2(Spell, Weapons, Non-Weapons, Age, Birthday, Next Change, Height, Weight)
  141. .DE
  142. .P
  143. .ne 5.0i
  144. The calls
  145. .P
  146. .DS I
  147. title(Garth, Human, Fighter, 4, LG)
  148. stats(17, 13, 12, 18, 10, 12)
  149. stats1(1,35,0,1-2,7,right,male)
  150. stats2(,5,2,23,1st June,30,72,160)
  151. .DE
  152. .P
  153. will produce
  154. .P
  155. .PS
  156. title(Garth, Human, Fighter, 4, LG)
  157. stats(17, 13, 12, 18, 10, 12)
  158. stats1(1,35,0,1-2,7,right,male)
  159. stats2(,5,2,23,1st June,30,72,160)
  160. .PE
  161. .H 2 "The \fBhandweapon\fP Macro"
  162. The \fBhandweapon\fP macro takes an argument of the number of lines required
  163. for proficiencies with hand held weapons.
  164. Succesive calls to the \fBhweapon\fP macro then fill it lines with details of
  165. specific proficient weapons.
  166. .P
  167. The specific arguments to the macros are
  168. .P
  169. .DS I
  170. .ft C
  171. handwepon(number of slots)
  172. hweapon(name, atks, number of slots allocated, speed, thac0, s-m, l)
  173. .DE
  174. .P
  175. .ne 3.5i
  176. The calls
  177. .P
  178. .DS I
  179. .ft C
  180. title(Garth, Human, Fighter, 4, LG)
  181. handweapon(3)
  182. hweapon(Long Sword, 3/2, 2, 5, 17, 1-8, 1-12)
  183. hweapon(Mace, 1, 1, 7, 18, 2-7, 1-6)
  184. .DE
  185. .P
  186. Will produce
  187. .P
  188. .PS
  189. title(Garth, Human, Fighter, 4, LG)
  190. handweapon(3)
  191. hweapon(Long Sword, 3/2, 2, 5, 17, 1-8, 1-12)
  192. hweapon(Mace, 1, 1, 7, 18, 2-7, 1-6)
  193. .PE
  194. .H 2 "The \fBthrowweapon\fP Macro"
  195. The \fBthrowweapon\fP macro and the \fBtweapon\fP pefrom the equivalent
  196. functions for ranged weapons.
  197. .P
  198. The specific arguments to the macros are
  199. .P
  200. .DS I
  201. .ft C
  202. throwweapon(number)
  203. tweapon(name, s, m, l, atks, number of slots allocated, thac0, s-m, l)
  204. .DE
  205. .P
  206. .ne 3.0i
  207. The calls
  208. .P
  209. .DS I
  210. .ft C
  211. title(Garth, Human, Fighter, 4, LG)
  212. throwweapon(2)
  213. tweapon(Long Bow, 2, 6, 10, 2, 1, 18, 1-6, 1-6)
  214. tweapon(Dagger, 1, 2, 4, 2, 1, 18, 1-4, 1-3)
  215. .DE
  216. .P
  217. Will produce
  218. .P
  219. .PS
  220. title(Garth, Human, Fighter, 4, LG)
  221. throwweapon(2)
  222. tweapon(Long Bow, 2, 6, 10, 2, 1, 18, 1-6, 1-6)
  223. tweapon(Dagger, 1, 2, 4, 2, 1, 18, 1-4, 1-3)
  224. .PE
  225. .H 2 "The \fBnonweapon\fP Macro"
  226. The \fBnonweapon\fP and \fBnweapon\fP macros perform the same function for
  227. non-weapon proficiencies.
  228. .P
  229. The specific arguments to the macros are
  230. .P
  231. .DS I
  232. .ft C
  233. nonweapon(number)
  234. nweapon(name, number of slots used, attribute, modifier)
  235. .DE
  236. .P
  237. .ne 3.0i
  238. The calls
  239. .P
  240. .DS I
  241. .ft C
  242. title(Garth, Human, Fighter, 4, LG)
  243. nonweapon(2)
  244. nweapon(Healing, 2, Wis, 0)
  245. nweapon(Juggling, 1, Dex, +2)
  246. .DE
  247. .P
  248. Will produce
  249. .P
  250. .PS
  251. title(Garth, Human, Fighter, 4, LG)
  252. nonweapon(2)
  253. nweapon(Healing, 2, Wis, 0)
  254. nweapon(Juggling, 1, Dex, +2)
  255. .PE
  256. .H 2 "The \fBlanguages\fP Macro"
  257. The \fBlanguages\fP macro creates space to record known languages.
  258. The argument is rounded up to give a minimum of 4 slots increasing by groups
  259. of 3 from there.
  260. The \fBlanguage\fP macro is then used to record known languages.
  261. .P
  262. .ne 3.0i
  263. The calls
  264. .P
  265. .DS I
  266. .ft C
  267. title(Garth, Human, Fighter, 4, LG)
  268. languages(10)
  269. language(common)
  270. language(elvish)
  271. language(orcish)
  272. language(thieves cant)
  273. language(chinese)
  274. .DE
  275. .P
  276. Will produce
  277. .P
  278. .PS
  279. title(Garth, Human, Fighter, 4, LG)
  280. languages(10)
  281. language(common)
  282. language(elvish)
  283. language(orcish)
  284. language(thieves cant)
  285. language(chinese)
  286. .PE
  287. .H 2 "The \fBsaves\fP Macro"
  288. The \fBsaves\fP macros is used to record saving throws and takes the standard
  289. set of 5 saves as arguments.
  290. .P
  291. The specific arguments to the macro are
  292. .P
  293. .DS I
  294. .ft C
  295. saves(Poison Death Magic, Paralysation, Rod Staff or Wand \\
  296.     Paralysation, Petrification or Polymorph, Breath Weapon, Spell or Magic)
  297. .DE
  298. .P
  299. .ne 3.0i
  300. The calls
  301. .P
  302. .DS I
  303. .ft C
  304. title(Garth, Human, Fighter, 4, LG)
  305. saves(16, 15, 14, 15, 17)
  306. .DE
  307. .P
  308. Will produce
  309. .P
  310. .PS
  311. title(Garth, Human, Fighter, 4, LG)
  312. saves(16, 15, 14, 15, 17)
  313. .PE
  314. .H 2 "The \fBthief\fP Macro"
  315. The \fBthief\fP macro records thief's skill for those characters possesing
  316. them,
  317. and takes the values for the skills as its arguments.
  318. .P
  319. The specific arguments to the macros are
  320. .P
  321. .DS I
  322. .ft C
  323. thief(pick pockets, open locks, find/remove traps, move silently,  \\
  324.     hide in shadows, hear noise, climb walls, read languages)
  325. .DE
  326. .P
  327. .ne 3.0i
  328. The calls
  329. .P
  330. .DS I
  331. .ft C
  332. title(Garth, Human, Fighter/Thief, 4/3, LG)
  333. thief(25, 55, 30, 47, 78, 55, 22, 97, 10)
  334. .DE
  335. .P
  336. Will produce
  337. .P
  338. .PS
  339. title(Garth, Human, Fighter/Thief, 4/3, LG)
  340. thief(25, 55, 30, 47, 78, 55, 22, 97, 10)
  341. .PE
  342. .H 2 "The \fBencumbrance\fP Macro"
  343. This macro calculates the weight allowance and movement rate numbers
  344. from the encumbrance optional rule (Players Handbook p78),
  345. it takes one argument, the characters base movement rate of either 6 or 12
  346. inches and also picks up the characters strength from a prior call to the
  347. \fBstats\fP macro\(dg,
  348. in fact it is a requirement that \fBstats\fP be called prior to
  349. \fBencumbrance\fP.
  350. .FS \(dg
  351. Due to some limitations on arithmetic inside pic fighters exceptional strength
  352. ratings (18 plus percentile) should be given to the \fBstats\fP macro as 18.35
  353. etc.
  354. .FE
  355. .P
  356. .ne 3.5i
  357. The calls
  358. .P
  359. .DS I
  360. .ft C
  361. title(Garth, Human, Fighter, 4, LG)
  362. encumbrance(12)
  363. .DE
  364. .P
  365. Will produce
  366. .P
  367. .PS
  368. title(Garth, Human, Fighter, 4, LG)
  369. encumbrance(12)
  370. .PE
  371. .H 2 "The \fBcompanions\fP Macro"
  372. The \fBcompanions\fP and \fBcompanion\fP macros are designed to record
  373. information about other creatures associated with a main character.
  374. For example mounts,
  375. a wizards familiar,
  376. henchmen etc.
  377. .P
  378. The specific arguments to the macros are
  379. .P
  380. .DS I
  381. .ft C
  382. companions(number)
  383. companion(name, race, ac, hd or level, thac0, hp, #atks, dam, special)
  384. .DE
  385. .P
  386. .ne 3.0i
  387. The calls
  388. .P
  389. .DS I
  390. .ft C
  391. title(Garth, Human, Fighter, 4, LG)
  392. companions(3)
  393. companion(Dobbin,Medium Warhorse,6,2+2,17,13,3,1-6,1-6,1-4,)
  394. .DE
  395. .P
  396. Will produce
  397. .P
  398. .PS
  399. title(Garth, Human, Fighter, 4, LG)
  400. companions(3)
  401. companion(Dobbin,Medium Warhorse,6,2+2,17,13,3,1-6,1-6,1-4,)
  402. .PE
  403. .H 2 "The \fBequipment\fP Macro"
  404. The \fBequipment\fP,
  405. \fBcontainer\fP and \fBitem\fP macros are to record equipment carried by the
  406. character and how it is distributed.
  407. The \fBequipment\fP macro takes an argument of the number of discrete
  408. container to be recorded,
  409. which is rounded up to an even number.
  410. It's second argument is the number of space for items to be left in each
  411. container.
  412. The \fBcontainer\fP macro records the details of each container,
  413. its weight,
  414. capacity and laden weight.
  415. Calls to the \fBitem\fP macro then fill in individual entries in the current
  416. container.
  417. .P
  418. The specific arguments to the macros are
  419. .P
  420. .DS I
  421. .ft C
  422. equipment(number of containers, entries per container)
  423. container(name, capacity, container weight, total weight)
  424. item(magic, name, weight)
  425. .DE
  426. .P
  427. .ne 5.5i
  428. The calls
  429. .P
  430. .DS I
  431. .ft C
  432. title(Garth, Human, Fighter, 4, LG)
  433. equipment(2, 4)
  434. container(Clothes,,5,9)
  435. item(,Dagger,3)
  436. item(*,Wand of Fireball[12],1)
  437. container(Backpack,170,10,47)
  438. item(,4 Oil Flask,30)
  439. item(,Iron Rations,5)
  440. item(*,Potion of Heroism,2)
  441. .DE
  442. .P
  443. Will produce
  444. .P
  445. .PS
  446. title(Garth, Human, Fighter, 4, LG)
  447. equipment(2, 4)
  448. container(Clothes,,5,9)
  449. item(,Dagger,3)
  450. item(*,Wand of Fireball[12],1)
  451. container(Backpack,170,10,47)
  452. item(,4 Oil Flask,30)
  453. item(,Iron Rations,5)
  454. item(*,Potion of Heroism,2)
  455. .PE
  456. .H 2 "The \fBtakelist\fP Macro"
  457. The \fBtakelist\fP macros is used to allocate space for recording treasure and other items
  458. found by a party during an adventure.
  459. .P
  460. The specific arguments to the macros are
  461. .P
  462. .DS I
  463. .ft C
  464. takelist(number of entries)
  465. .DE
  466. .P
  467. .ne 5.5i
  468. The calls
  469. .P
  470. .DS I
  471. .ft C
  472. title(Garth, Human, Fighter, 4, LG)
  473. takelist(6)
  474. .DE
  475. .P
  476. Will produce
  477. .P
  478. .PS
  479. title(Garth, Human, Fighter, 4, LG)
  480. takelist(6)
  481. .PE
  482. .H 2 "The \fBnotes\fP Macro"
  483. The \fBnotes\fP macro is to be used at the foot of a page to mark the
  484. remaining space for general note taking.
  485. It takes no arguments.
  486. .P
  487. .ne 2.5i
  488. The calls
  489. .P
  490. .DS I
  491. .ft C
  492. title(Garth, Human, Fighter, 4, LG)
  493. notes()
  494. .DE
  495. .P
  496. Will produce
  497. .P
  498. .PS
  499. title(Garth, Human, Fighter, 4, LG)
  500. notes()
  501. .PE
  502. .H 2 "The \fBmoney\fP Macro"
  503. The \fBmoney\fP macro is similar to the \fBnotes\fP macros in that it is used
  504. at the foot of a page,
  505. it marks the remaining space for use recording money and experience.
  506. It takes three arguments,
  507. current values for gold and experience and the next level break or breaks.
  508. .P
  509. .ne 2.5i
  510. The calls
  511. .P
  512. .DS I
  513. .ft C
  514. title(Garth, Human, Fighter, 4, LG)
  515. money(532, 4355, 5000)
  516. .DE
  517. .P
  518. Will produce
  519. .P
  520. .PS
  521. title(Garth, Human, Fighter, 4, LG)
  522. money(532, 4355, 5000)
  523. .PE
  524. .H 2 "The \fBspells\fP Macro"
  525. The \fBspells\fP macro is used to provide space to record currently or
  526. normally memorised spells,
  527. including such information as casting time,
  528. range and duration.
  529. It takes two arguments,
  530. the level of spell and the number of spaces to provide.
  531. It is intended that spaces be allocated for slightly more than the number
  532. of spells which can be memorised of that level,
  533. to allow all spells of that level which are normally memorised to be recorded.
  534. The \fBspell\fP macro is then used to fill in particular spells.
  535. .P
  536. .ne 4.5i
  537. The calls
  538. .P
  539. .DS I
  540. .ft C
  541. title(Garth, Human, Fighter, 4, LG)
  542. spells(4, 6)
  543. spell(Faerie Fire,2,5r,10x10,20yds,yes)
  544. spell(Sanctuary,2,7r,10x10,50yds,no)
  545. .DE
  546. .P
  547. Will produce
  548. .P
  549. .PS
  550. title(Garth, Human, Fighter, 4, LG)
  551. spells(4, 6)
  552. spell(Faerie Fire,2,5r,10x10,20yds,yes)
  553. spell(Sanctuary,2,7r,10x10,50yds,no)
  554. .PE
  555. .H 2 "The \fBspellbook\fP Macro"
  556. This is similar to the \fBspells\fP macro but is intended for use in
  557. maintaining a spellbook so spaces should be allocated for the maximum number
  558. of spells knowable at each level.
  559. The \fBspellbook\fP macro also leaves a blank line with each spell for
  560. recording a synopsis of the spell.
  561. .P
  562. .ne 6.5i
  563. The calls
  564. .P
  565. .DS I
  566. .ft C
  567. title(Garth, Human, Fighter, 4, LG)
  568. spellbook(2, 4)
  569. .DE
  570. .P
  571. Will produce
  572. .P
  573. .PS
  574. title(Garth, Human, Fighter, 4, LG)
  575. spellbook(2, 4)
  576. .PE
  577. .H 1 "Examples"
  578. .ne 5.0i
  579. .H 2 "A General Blank Sheet"
  580. .P
  581. .DS I
  582. .ft C
  583. \\.po -0.5i
  584. \\.PS
  585. copy "../macros/main"
  586. title(, , , ,)
  587. stats(0,,,,,)
  588. handweapon(3)
  589. throwweapon(2)
  590. saves(,,,,)
  591. nonweapon(3)
  592. thief(,,,,,,,)
  593. encumbrance(12)
  594. equipment(2,8)
  595. companions(2)
  596. languages(8)
  597. money
  598. \\.PE
  599. .DE
  600.